Tags

[POST] /api/v2/common/tags/{tagId}/documents

查询与特定标签关联的文档并对结果进行分页。

参数:

名称	类型	位置	描述
tagId必填项	string	path	用于筛选文档的标签的唯一标识符。预期格式：UUID。示例：ab8dc626-2d0a-4a58-908a-35ad7ab30422

This method handles pagination based on the parameters provided in the model.
It filters documents by the specified tagId and applies additional filters and sorting as specified in the model.

请求数据格式

DocumentTagPaginationRequestModel

返回值

状态码: 200

成功

DocumentPaginationResponseModel

状态码: 400

错误的请求

ServerPluginError

[GET] /api/v2/common/tags

根据各种筛选条件检索标签信息。

参数:

名称	类型	位置	描述
tagId	string	query	标签的唯一标识符。用于筛选结果，仅包含此标签。例如：“12345”
names	string	query	以逗号分隔的标签名称列表。用于筛选结果，仅包含这些名称。例如：“Tag1,Tag2”
name	string	query	单个标签名称。用于筛选结果，仅包含此名称。例如：“Tag3”
filterByType	string	query	根据文档类型应用筛选条件。例如：“DocumentType”
disableHideInDocumentPortalFilter	Boolean	query	用于禁用文档门户中隐藏文档的筛选器的标志。例如：false
isFromExportPage	Boolean	query	指示查询是否源自导出页面的标志。例如：true
needDocumentCount	Boolean	query	指示是否在响应中包含与每个标签关联的文档计数的标志。例如：true
type	string	query	要查询的标签类型。默认值为“全部”。例如：“自定义”。

返回值

状态码: 200

成功

TagResponseListModel

状态码: 400

错误的请求

ServerPluginError

[POST] /api/v2/common/tags

根据提供的标签详细信息，向系统中添加新标签。此操作会创建一个具有指定属性的标签，包括名称、顺序和权限。

请求数据格式

TagsRequestModel

返回值

状态码: 200

成功

AddTagResponseModel

状态码: 400

错误的请求

ServerPluginError

[PUT] /api/v2/common/tags/{tagId}

更新由 tagId 标识的现有标签的详细信息。

参数:

名称	类型	位置	描述
tagId必填项	string	path	要更新的标签的唯一标识符。预期格式：UUID。示例：ab8dc626-2d0a-4a58-908a-35ad7ab30422

请求数据格式

TagsRequestModel

返回值

状态码: 200

成功

UpdateTagResponseModel

状态码: 400

错误的请求

ServerPluginError

状态码: 404

未找到

ServerPluginError

[DELETE] /api/v2/common/tags/{tagId}

根据提供的标签 ID 从系统中删除标签。

参数:

名称	类型	位置	描述
tagId必填项	string	path	要删除的标签的唯一标识符。预期格式：UUID。例如：ab8dc626-2d0a-4a58-908a-35ad7ab30422

返回值

状态码: 200

成功

Array<string>

状态码: 400

错误的请求

ServerPluginError

状态码: 404

未找到

ServerPluginError

[POST] /api/v2/common/tags/move

将标签从一个父标签移动到另一个父标签，或者改变其在标签结构中的层级结构。

请求数据格式

MoveTagRequestModel

返回值

状态码: 200

成功

Array<string>

状态码: 400

错误的请求

ServerPluginError

类型定义

Ƭ DocumentPaginationResponseModel

表示分页文档查询的响应模型。

名称	类型	描述	示例
pagination	PaginationModel
data可为空	DocumentVO	一个只读的文档视图对象 (VO) 列表，代表文档的当前页面。每个 DocumentVO 都包含文档元数据以及显示或处理所需的任何其他信息。

Ƭ PaginationModel

此模型用于表示返回项目列表的查询的分页信息。它通过指定每页的大小和当前页码来管理大型数据集的分页。

名称	类型	描述
pageSize	int32	获取或设置单个页面上要显示的项目数量。
pageNumber	int32	获取或设置当前页码。
total	int64	获取或设置所有页面上的项目总数。

Ƭ DocumentVO

表示文档的视图对象，封装了各种元数据和状态信息。

名称	类型	描述
created可为空	ISO DateTime Sting	文档的创建时间戳。
deleted可为空	ISO DateTime Sting	如果文档已被删除，则显示文档的删除时间戳。
modified可为空	ISO DateTime Sting	文档的最后修改时间戳。
createdBy	SampleUserResponseModel
modifiedBy	SampleUserResponseModel
deletedBy	SampleUserResponseModel
description可为空	string	文件简介。
displayName可为空	string	文档的显示名称。
ext可为空	string	文档的文件扩展名。
hideInDocumentPortal	Boolean	指示文档是否在文档门户中隐藏。
hideOnMobile	Boolean	指示该文档是否在移动设备上隐藏。
id可为空	string	文档的唯一标识符。
isResource	Boolean	指示该文档是否为资源。
meta可为空	string	与文档相关的元数据。
organizationId可为空	string	与该文档关联的组织 ID。
organizationIdPath可为空	string	与文档关联的组织 ID 路径。
thumbnail可为空	string	文档缩略图的URL。
title可为空	string	文档标题。
type可为空	string	文档类型。
customPermissions可为空	`Array<string>`	与文档关联的自定义权限。
contentUrl可为空	string	访问文档内容的URL。
revisionNo	int32	文档的修订号。
revisionContentUrl可为空	string	访问特定文档版本内容的URL。
isSystemReserved	Boolean	指示该文档是否已被系统预留。
effectiveOps可为空	string	允许对文档进行有效操作。
security	SecurityResponseModel
references可为空	ReferenceResponseModel	与该文档相关的参考文献。
revisions可为空	RevisionResponseModel	文档修订历史。
tags可为空	TagResponseInfoModel	与文档关联的标签。
draft	DraftVO

Ƭ SampleUserResponseModel

代表一个简化的用户模型，提供各种响应模型中使用的基本信息。

名称	类型	描述	示例
id可为空	string	用户的唯一标识符。
name可为空	string	用户名。

Ƭ SecurityResponseModel

文档的安全设置。

名称	类型	描述	示例
ownerId可为空	string	所有者的唯一标识符。
permissions可为空	AclEntryQueryModel	文档访问权限。

Ƭ ReferenceResponseModel

表示文档引用的模型，包括有关文档及其权限的详细信息。

名称	类型	描述
documentId可为空	string	被引用文档的唯一标识符。
resourceName可为空	string	文档所关联的资源名称。
resourceDocType可为空	string	资源文档的类型。
resourceDocExt可为空	string	文档的文件扩展名。
resourceDocName可为空	string	资源文档的名称。
directReferencesIds可为空	`Array<string>`	父文档 ID。
displayName可为空	string	参考文献的显示名称。
meta可为空	string	与文档相关的元数据。
documentRev可为空	string	文件修订。
isDirectChild	Boolean	指示该文档是否为父文档的直接子文档。
permission可为空	string	文档的权限级别。
contentUrl可为空	string	访问文档内容的URL。
minimalPermission可为空	string	访问该文档所需的最低权限。

Ƭ RevisionResponseModel

表示文档修订的模型，包括修订号、注释、元数据和相关用户信息等详细信息。

名称	类型	描述
no	int32	版本号。通常是一个整数，每次新版本发布时都会递增。
comment可为空	string	对本次修订所做的更改进行描述。
meta可为空	string	与版本相关的元数据，可能包括标签或关键词等详细信息。
createdBy	SampleUserResponseModel
created可为空	ISO DateTime Sting	此版本创建的日期和时间。
modifiedBy	SampleUserResponseModel
modified可为空	ISO DateTime Sting	此版本最后修改的日期和时间。
contentUrl可为空	string	访问此版本内容的网址。
references可为空	ReferenceResponseModel	与本次修订相关的参考资料列表，例如相关文档或资源。

Ƭ TagResponseInfoModel

表示标签的响应模型，包括其元数据和状态。

名称	类型	描述
id可为空	string	标签的唯一标识符。
parentId可为空	string	父标签的唯一标识符（如有）。
realName可为空	string	标签的显示名称。
order	int32	标签在其同级元素中的显示顺序。
url可为空	string	与标签关联的 URL，通常用于导航。
iconCssClass可为空	string	用于视觉呈现的标签图标的 CSS 类。
color可为空	string	标签关联的颜色，用于视觉呈现。
isFavorites	Boolean	指示该标签是否被标记为收藏。
isPersonal	Boolean	指示该标签是否为用户个人所有。
orgId可为空	string	与该标签关联的组织的唯一标识符。
documentCount	int32	与该标签关联的文档数量。
name可为空	string	用于识别和搜索的标签名称。
isSharedFolder	Boolean	指示该标签是否为共享文件夹。
autoAssignMinPermissions	Boolean	指示是否自动分配最低权限。
documentGrant可为空	AccessEntryStringDto	获取共享文件夹下文档的访问权限列表。
sharedFolderGrant可为空	AccessEntryStringDto	获取共享文件夹的访问权限列表。

Ƭ DraftVO

表示草稿文档的视图模型，封装了与草稿相关的所有相关信息和元数据。

名称	类型	描述
id可为空	string	草稿的唯一标识符。
type可为空	string	草稿类型。
title可为空	string	草案标题。
displayName可为空	string	草稿的显示名称。
description可为空	string	草案简述。
ext可为空	string	草稿文档的文件扩展名。
createdBy	SampleUserResponseModel
created可为空	ISO DateTime Sting	草稿的创建日期和时间。
isDraft	Boolean	指示该文档是否为草稿。
isApproval	Boolean	表明该草案是否需要批准。
contentType可为空	string	草稿的内容类型。
contentUrl可为空	string	访问草案内容的网址。
revisionNo	int32	草案的修订号。
revisionContentUrl可为空	string	访问该草案特定修订版本内容的网址。
isSystemReserved	Boolean	表示该选秀权是否已被系统保留。
hideOnMobile	Boolean	指示是否应在移动设备上隐藏草稿。
meta可为空	string	草稿相关的元数据。
hideInDocumentPortal	Boolean	指示是否应在文档门户中隐藏草稿。
isResource	Boolean	指示该文档是否被视为资源。
organizationId可为空	string	与该草案相关的组织标识符。
organizationIdPath可为空	string	与草案关联的组织标识符路径。
thumbnail可为空	string	草稿缩略图的网址。
modified可为空	ISO DateTime Sting	草稿最后修改的日期和时间。
modifiedBy	SampleUserResponseModel
customPermissions可为空	`Array<string>`	与草稿关联的自定义权限列表。
effectiveOps可为空	string	对草稿可以进行的有效操作。
security	SecurityResponseModel
references可为空	ReferenceResponseModel	该草案的相关参考文献列表。
revisions可为空	RevisionResponseModel	草案修订清单。

Ƭ AclEntryQueryModel

定义子角色的 ACL 条目权限。

名称	类型	描述
sub	RoleResponseModel
ops可为空	`Array<string>`	已授权的操作。
opflags	int32	用于额外控制的操作标志。

Ƭ RoleResponseModel

代表系统中的一个角色。

名称	类型	描述
id可为空	string	角色的唯一标识符。
name可为空	string	职位名称。
type可为空	string	职位类型。

Ƭ AccessEntryStringDto

访问入口字符串 Dto

名称	类型	描述	示例
role可为空	string	角色名称	`"Tester"`
ops可为空	`Array<string>`	操作：/ 执行：["执行"] / 读取：["执行", "读取"] / 写入：["执行", "读取", "更新"]	`["Execute","Read","Update"]`

Ƭ ServerPluginError

服务器插件错误

名称	类型	描述
code可为空	string	错误代码
message可为空	string	错误信息
context可为空	string	错误上下文
innerError	ServerPluginError
extensions可为空	any	扩展结果

Ƭ DocumentTagPaginationRequestModel

文档分页请求模型

名称	类型	描述	示例
documentId可为空	string	获取或设置文档 ID。	`"e3808c7e-c0e7-44da-96a2-200b3bb216c6"`
pageSize	int32	获取或设置每页显示的文档数量。	`10`
pageNumber	int32	获取或设置要显示的页码。	`1`
orderBy可为空	string	获取或设置用于对文档进行排序的字段。	`"creationDate"`
disableHideInDocumentPortalFilter	Boolean	获取或设置一个值，该值指示是否禁用文档门户中的隐藏筛选器。
filterByType可为空	string	获取或设置要筛选的文档类型。	`"report"`
isFromExportPage	Boolean	获取或设置一个值，该值指示查询是否来自导出页面。
search可为空	string	获取或设置文档标题的搜索关键字。	`"annual report"`
createdTimeRange可为空	`Array<string>`	获取或设置文档的创建时间范围。
modifiedTimeRange可为空	`Array<string>`	获取或设置文档的修改时间范围。
creator可为空	string	获取或设置文档的创建者。	`"John Doe"`
modifier可为空	string	获取或设置文档的修饰符。	`"Jane Smith"`
lng可为空	string	获取或设置语言代码。	`"en-US"`
extendQuery	ExtendQuery
includeIndirectReference	Boolean	获取或设置一个值，该值指示是否包含间接引用文档。仅当 extendQuery 表示的含义包含“引用”时，此配置才生效。	`true`

Ƭ ExtendQuery

Enum:

None
EffectiveOps
Security
References
Revisions
Tags
Draft
All

定义用于扩展文档查询的选项。

此枚举允许指定应在文档查询响应中包含哪些附加数据。
它支持位运算以组合多个选项。

* None - 0 - 不包含任何附加数据。
* EffectiveOps - 1 - 包含适用于文档的有效操作。
* Security - 2 - 包含安全信息，例如访问控制列表。
* References - 4 - 包含对其他文档的引用。
* Revisions - 8 - 包含有关文档修订的信息。
* Tags - 16 - 包含与文档关联的标签。
* Draft - 32 - 包含与文档关联的草稿信息。
* All - 63 - 包含所有可用的扩展信息。

Ƭ TagResponseListModel

名称	类型	描述	示例
tagsInfo可为空	TagResponseInfoModel

Ƭ AddTagResponseModel

表示添加标签的响应模型，包含新添加标签的唯一标识符。

名称	类型	描述	示例
tagId可为空	string	所添加标签的唯一标识符。

Ƭ TagsRequestModel

表示创建或更新标签的请求模型，包括名称、顺序和权限等详细信息。

名称	类型	描述	示例
name可为空	string	获取标签的名称。	`"sales"`
urlName可为空	string	获取标签的 URL 友好名称。	`"sales"`
order可为空	int32	获取标签在其层级结构或列表中的显示顺序。	`301266`
organizationId可为空	string	获取标签所属组织的唯一标识符。	`"63191df0-9464-4cf7-8d4b-07a63208d209"`
isPersonal	Boolean	指示该标签是否为用户个人所有。
parentId可为空	string	获取父标签的唯一标识符（如果有）。	`"6825c89e-2a9b-494c-8e98-3d21bacd79fb"`
color可为空	string	获取与标签关联的颜色。	`"#FF5733"`
iconCssClass可为空	string	获取标签图标的 CSS 类。	`"mdi mdi-account"`
grant可为空	AccessEntryDto	获取标签已授予的访问权限列表。
isSharedFolder	Boolean	指示该标签是否为共享文件夹。
autoAssignMinPermissions	Boolean	指示是否自动分配最低文档权限。
documentGrant可为空	AccessEntryStringDto	获取共享文件夹下文档的访问权限列表。
sharedFolderGrant可为空	AccessEntryStringDto	获取共享文件夹的访问权限列表。

Ƭ AccessEntryDto

访问入口 Dto

名称	类型	描述	示例
role可为空	string	角色名称
ops可为空	Operations	运营

Ƭ Operations

Enum:

None
Create
Read
Update
Delete
Modify
ChangePermission
Execute
FullControl
All

Ƭ UpdateTagResponseModel

表示更新标签的响应模型，包含已更新标签的唯一标识符。

名称	类型	描述	示例
tagId可为空	string	已更新标签的唯一标识符。

Ƭ MoveTagRequestModel

表示将标签从一个父级移动到另一个父级或改变其在层次结构中的位置的请求模型。

名称	类型	描述	示例
fromTagId可为空	string	获取正在移动的标签的唯一标识符。	`"fromTag123"`
toTagId可为空	string	获取目标标签的唯一标识符。	`"toTag456"`
updateParent	Boolean	指示在移动操作中是否应该更新父标签。	`true`
toParentTagId可为空	string	如果父标签正在更新，则获取新父标签的唯一标识符。	`"newParent789"`